home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr38 / oeb116.zip / OEB.DOC < prev    next >
Text File  |  1995-04-21  |  18KB  |  542 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                    ░░░░▄  ░░░▄░░▄ ░░▄    ░░▄ ░░░▄░░▄ ░░░░░▄
  8.                   ░░█▀░░▄ ░░░░░░█ ░░█    ░░█ ░░░░░░█ ░░█▀▀▀
  9.                   ░░█ ░░█ ░░█░░░█ ░░█    ░░█ ░░█░░░█ ░░░▄
  10.                   ░░█ ░░█ ░░█ ░░█ ░░█    ░░█ ░░█ ░░█ ░░█▀
  11.                    ░░░░█▀ ░░█ ░░█ ░░░░░▄ ░░█ ░░█ ░░█ ░░░░░▄
  12.                     ▀▀▀▀   ▀▀  ▀▀  ▀▀▀▀▀  ▀▀  ▀▀  ▀▀  ▀▀▀▀▀
  13.  
  14.      ░░░░░▄ ░░▄    ░░░░░▄  ░░░░▄  ░░░░░░▄ ░░░░░▄   ░░░░▄  ░░░▄░░▄ ░░▄  ░░░░▄
  15.      ░░█▀▀▀ ░░█    ░░█▀▀▀ ░░█▀░░▄  ▀░░█▀▀ ░░█▀░░▄ ░░█▀░░▄ ░░░░░░█ ░░█ ░░█▀░░▄
  16.      ░░░▄   ░░█    ░░░▄   ░░█  ▀▀   ░░█   ░░░░░█▀ ░░█ ░░█ ░░█░░░█ ░░█ ░░█  ▀▀
  17.      ░░█▀   ░░█    ░░█▀   ░░█ ░░▄   ░░█   ░░█▀░░▄ ░░█ ░░█ ░░█ ░░█ ░░█ ░░█ ░░▄
  18.      ░░░░░▄ ░░░░░▄ ░░░░░▄  ░░░░█▀   ░░█   ░░█ ░░█  ░░░░█▀ ░░█ ░░█ ░░█  ░░░░█▀
  19.       ▀▀▀▀▀  ▀▀▀▀▀  ▀▀▀▀▀   ▀▀▀▀     ▀▀    ▀▀  ▀▀   ▀▀▀▀   ▀▀  ▀▀  ▀▀   ▀▀▀▀
  20.  
  21.               ░░░░░▄   ░░░░▄  ░░░▄░░▄ ░░▄ ░░▄ ░░▄ ░░░▄░░▄  ░░░░▄
  22.               ░░█▀░░▄ ░░█▀░░▄ ░░░░░░█ ░░█░░░█ ░░█ ░░░░░░█ ░░█▀▀▀
  23.               ░░░░░░█ ░░░░░░█ ░░█░░░█ ░░░░█▀▀ ░░█ ░░█░░░█ ░░█░░░▄
  24.               ░░█▀░░█ ░░█ ░░█ ░░█ ░░█ ░░█░░░▄ ░░█ ░░█ ░░█ ░░█ ░░█
  25.               ░░░░░█▀ ░░█ ░░█ ░░█ ░░█ ░░█ ░░█ ░░█ ░░█ ░░█  ░░░░█▀
  26.                ▀▀▀▀▀   ▀▀  ▀▀  ▀▀  ▀▀  ▀▀  ▀▀  ▀▀  ▀▀  ▀▀   ▀▀▀▀
  27.  
  28.                                 Version 1.16
  29.  
  30.  
  31.                                 By Tim Rider
  32.  
  33.                          IBSA BBS - (310) 204-3249
  34.                       The Source BBS - (310) 371-3737
  35.  
  36.                                  Internet:
  37.                            tim.rider@ibsabbs.com
  38.                             tim.rider@tsbbs.com
  39.  
  40.  
  41.  
  42.   Disclaimer
  43.   ══════════
  44.     Online Electronic Banking(tm) is supplied as is.  The author disclaims
  45.   all warranties, expressed or implied, including, without limitation, the
  46.   warranties of merchantability and of fitness for any purpose. The author
  47.   assumes no liability for damages, direct or consequential, which may
  48.   result from the use, or inability to use, Online Electronic Banking(tm).
  49.  
  50.  
  51.  
  52.   ┌────────────────────────────────────────────────────────────────────────┐
  53.   │ Before You Start!                                                      │
  54.   │ ═════════════════                                                      │
  55.   │ Make sure to read SYSOEB.DOC as it contains information necessary to   │
  56.   │ sign up for this service.                                              │
  57.   └────────────────────────────────────────────────────────────────────────┘
  58.  
  59.  
  60. ■ OEB.DOC, Page 1
  61.  
  62.   Summary
  63.   ═══════
  64.  
  65.     o Includes two doors, check entry door and catalog sales door.
  66.     o Wildcat! WCCode script for automatic subscription purchases included.
  67.  
  68.     OEB Check-Entry Door
  69.     ────────────────────
  70.       o Allows you to take electronic check payments online.
  71.       o Easy to understand data entry screen with strict data verification.
  72.       o Fully automated system, including an automated communications program
  73.         to transfer transaction data to be processed.
  74.       o Configuration program with full online help.
  75.       o RIP graphics support, but no RIP autodetect yet.
  76.  
  77.     OES Catalog-Sales Door
  78.     ──────────────────────
  79.       o Allows an unlimited online catalog of subscriptions, merchandise,
  80.         services, etc.
  81.       o Payment by OEB checks, VISA, MasterCard, American Express, and
  82.         Discover cards.  (Credit cards not handled by ATS)
  83.       o Automatically handles sales tax and shipping surcharges.
  84.       o Optional user-input field for information such as color, style, etc.
  85.       o Generates user-downloadable reciepts and convenient invoices
  86.         containing full customer information for the SysOp.
  87.       o Ability to offer downloadable files such as extended text
  88.         descriptions, GIF or PCX format photographs.  Define up to ten
  89.         extensions, ie: TXT, DOC, GIF, PCX, etc.
  90.       o Catalog searches by text string.
  91.       o Configuration program with full online help.
  92.  
  93.     Full Package
  94.     ────────────
  95.       o Supports any DOOR.SYS compatible BBS.
  96.       o Full text logging, activity log and transaction log.
  97.       o Fully multi-node aware.
  98.       o UART with non-standard IRQ and base address support, up to 8 ports.
  99.       o FOSSIL support, up to 8 ports.
  100.       o DigiBoard support, up to 8 ports.
  101.       o Shareware, only $20 for a key that will work with all future versions.
  102.  
  103.     Online Electronic Banking(tm) allows you to take payments online from a
  104.   user's checking account electronically.  Online Electronic Sales, allows
  105.   you to easily setup an online catalog of items to offer your users.  The
  106.   Online Electronic Sales door integrates seamlessly with Online Electronic
  107.   Banking(tm) to offer a complete sales solution.
  108.  
  109.       Online Electronic Banking(tm) works exlusively with Automated
  110.       Transaction Services, Inc.
  111.  
  112.     This program gives your users another method of online payment for
  113.   merchandise or subscriptions.  Many of your users may not have credit
  114.   cards, or may not want to give their credit card numbers out.  Now they
  115.   too have a fast and easy method of online payment.  The Online Electronic
  116.   Banking(tm) door makes it just as easy as making out a check, but it's all
  117.   done online.  The funds are sent to you within 24 to 48 hours, not a week
  118.   or two as users take their time filling out forms and mailing their check.
  119.  
  120. ■ OEB.DOC, Page 2
  121.  
  122.   Specifications
  123.   ══════════════
  124.     Online Electronic Banking(tm) is a door for WildCat!, PC-Board, and
  125.   any BBS that can generate a DOOR.SYS drop file.  The door supports up
  126.   to eight serial ports with non-standard IRQs and base addresses, eight
  127.   DigiBoard ports, and up to eight com ports on a FOSSIL driver.  The door
  128.   is also completely multi-node aware.
  129.  
  130.  
  131.  
  132.   Files Included
  133.   ══════════════
  134.  
  135.   HISTORY  DOC   5,753 04-21-95 1:16a  History of modifications, actually
  136.                                        worth skimming over.
  137.  
  138.   SYSOEB   DOC   8,210 04-21-95 1:16a  Information on Automated Transaction
  139.                                        Services, Inc.'s services.
  140.  
  141.   OEB      DAT   6,192 04-21-95 1:16a  Text Data for door
  142.  
  143.   OEB      EXE  59,433 04-21-95 1:16a  Online Electronic Banking Door
  144.  
  145.   OEBSETUP EXE  61,080 04-21-95 1:16a  Setup Program and Catalog Editor
  146.  
  147.   OEBSYSOP EXE  38,006 04-21-95 1:16a  Automated SysOp utility to send
  148.                                        transaction data to ATS for
  149.                                        processing.
  150.  
  151.   OES      EXE  62,125 04-21-95 1:16a  Online Electronic Sales Door
  152.  
  153.  
  154.   UPGRADE  EXE         04-21-95 1:16a  Upgrade Program (v1.14 to v1.16)
  155.  
  156.   OEBSETUP HLP  16,898 04-21-95 1:16a  Help File for OEBSETUP
  157.  
  158.   DISP     ZIP  13,185 04-21-95 1:16a  Display files to be placed in a
  159.                                        DISP sub-directory.
  160.  
  161.   WCSUB208 ZIP  17,412 04-21-95 1:16a  WC-Code Subscription Script for
  162.                                        Wildcat BBS'es, OEB SysOps get
  163.                                        a discounted registration of
  164.                                        $10.
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181. ■ OEB.DOC, Page 3
  182.  
  183.   Overview
  184.   ════════
  185.     This system of electronic check drafting or electronic funds transfer is
  186.   relatively simple, it couldn't possibly be any easier.  Everything is
  187.   automated from the second the user starts entering their transaction
  188.   information.  The process works like this:
  189.  
  190.     1) Taking Orders
  191.        ~~~~~~~~~~~~~
  192.        User browses through an online catalogue (The Online Electronic Sales
  193.        door) of merchandise or subscription information.  They decide to
  194.        order.  The user is made aware of the various options they have for
  195.        payment and chooses to pay with their bank account.
  196.  
  197.     2) Making a Payment
  198.        ~~~~~~~~~~~~~~~~
  199.        They enter the Online Electronic Banking(tm) door and enter their
  200.        check just as if they were making out a real check.  Transaction
  201.        information is stored in a database and logged in a text file.
  202.  
  203.     3) Processing Transactions
  204.        ~~~~~~~~~~~~~~~~~~~~~~~
  205.        As a nightly event, or as many times as you choose, you run the
  206.        OEBSYSOP.EXE Control Program to send any pending transaction
  207.        information to the OEB BBS, where it is then processed and the funds
  208.        transferred to you within one or two days.
  209.  
  210.     After installing the door and decided to go online with electronic check
  211.   payments, you will have to sign up for a merchant account per the
  212.   instructions in the beginning of this document.  When you sign up for your
  213.   merchant account, you will also be asked to register this program.  Read
  214.   the Afterword at the end of this file for information on how to obtain
  215.   your key file once you've registered.
  216.  
  217.  
  218.  
  219.   Quick Demo
  220.   ══════════
  221.  
  222.     To get a quick glimpse at the program...
  223.  
  224.       1) Unzip DISP.ZIP into a sub-directory named DISP.
  225.  
  226.       2) Run OEBSETUP to create the default configuration file.
  227.          (Just run the program then exit.)
  228.  
  229.          It may be a good idea to add a few bogus categories and items
  230.          so you can see how the catalog works.
  231.  
  232.       3) Type OES /L to view the Online Electronic Sales program in local
  233.          mode.
  234.            - or -
  235.          Type OEB /L to view the Online Electronic Banking Check-Entry door
  236.          in local mode.
  237.  
  238.  
  239.  
  240.  
  241. ■ OEB.DOC, Page 4
  242.  
  243.   Installation
  244.   ════════════
  245.   Step 1: Create a directory and unzip all the Online Electronic Banking(tm)
  246.           files into it.  (Example: C:\BBS\DOORS\OEB)
  247.  
  248.   Step 2: Create a sub-directory called DISP and unzip the contents of
  249.           DISP.ZIP into that directory.  These are the display files that
  250.           the door will display to the user.
  251.  
  252.   Step 3: Run the OEBSETUP program to modify your OEB.CFG.
  253.  
  254.            Note -  Online help is available by pressing [F1], it will make
  255.            ^^^^    the configuration process much easier.
  256.  
  257.           The only items necessary to change for a first time setup are:
  258.  
  259.             o The "Pay to the Order of" field under OEB Main Setup.
  260.             o The port configurations in the OEB Dialer Setup.
  261.  
  262.           If you plan to use the Online Electronic Sales door, you will want
  263.           to change the OES Main Setup information and define a catalog with
  264.           the catalog editor.
  265.  
  266.           Notice the setup program created three sub-directories:
  267.  
  268.             DATA        Where all pending transaction data is stored.
  269.             BACKUP      Where sent transaction data is held for seven days
  270.                         before being deleted.
  271.             LOGFILES    Where all log files created by OEB are stored.
  272.             CATALOG     Where the extended item information is stored.
  273.                         (GIF, PCX, TXT, ZIP files, etc)
  274.  
  275.   Step 4: Create a batch file to call the Online Electronic Banking(tm) door
  276.           from your BBS.  (Use OES in place of OEB if you want to use the
  277.           Online Electronic Sales door)
  278.  
  279.           (Example DOOR1.BAT for serial ports)
  280.  
  281.             @ECHO OFF
  282.             C:
  283.             CD\BBS\DOORS\OEB
  284.             OEB C:\BBS\WORK\NODE1
  285.  
  286.           (Example DOOR1.BAT for multi-node DigiBoard)
  287.  
  288.             @ECHO OFF
  289.             C:
  290.             CD\BBS\DOORS\OEB
  291.             OEB C:\BBS\WORK\NODE%NODEID% /D
  292.  
  293.           The command line parameters are:
  294.  
  295.             OEB <Path to DOOR.SYS> <Configuration File> /L /F /D
  296.  
  297.             <Path to DOOR.SYS> must always be specified unless in local mode.
  298.             <Configuration File> is optional, you can leave it blank.
  299.  
  300.  
  301. ■ OEB.DOC, Page 5
  302.  
  303.             Use the /F for FOSSIL mode.
  304.             Use the /D for DigiBoard mode.
  305.             Use the /L for local mode.  (no serial communications)
  306.  
  307.   Step 5: If you run a PC-Board BBS, add the following line to your BOARD.BAT
  308.           file:
  309.  
  310.             SET PCB=/NOCONF
  311.  
  312.           If a SET PCB line already exists, add /NOCONF to the end of it.
  313.  
  314.   Step 6: Give it a try!
  315.  
  316.  
  317.  
  318.   Non-Standard IRQ and Base Addresses
  319.   ═══════════════════════════════════
  320.  
  321.     If you are using a non-standard IRQ or base address, you need to define
  322.   the IRQ or base address you are using in an environment variable like
  323.   this:
  324.  
  325.     (Example DOOR1.BAT)
  326.  
  327.     @ECHO OFF
  328.     SET IRQID=4
  329.     SET BASEID=$3F8
  330.     C:
  331.     CD\BBS\DOORS\OEB
  332.     OEB C:\BBS\WORK\NODE1
  333.  
  334.     If you are using DesqView, you may want to add a blank SET IRQID and
  335.   SET BASEID to your AUTOEXEC.BAT to make sure there is enough room in the
  336.   DOS environment to store the IRQ and base address information in a
  337.   DesqView window.
  338.  
  339.  
  340.  
  341.   OES.EXE - The Online Electronic Sales Catalog
  342.   ═════════════════════════════════════════════
  343.     The Online Electronic Sales program is a full-featured online catalog
  344.   sales door that makes use of the Online Electronic Banking(tm) door.  Once
  345.   you have installed the OEB.EXE door, it's extremely simple to start using
  346.   the Online Electronic Sales program.  Simply run OES.EXE instead of
  347.   OEB.EXE, and make sure to edit the configuration information for OES using
  348.   OEBSETUP.EXE.
  349.  
  350.     Online Electronic Sales creates special log files for succesful sales.
  351.   In the LOGFILES directory, it will create SALESLOG.#, where # is the node
  352.   number.  These log files contain the details of the user's order and the
  353.   check information they entered so you can verify the authenticity of the
  354.   order.
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361. ■ OEB.DOC, Page 6
  362.  
  363.   OEBSYSOP.EXE - The SysOp Control Program
  364.   ════════════════════════════════════════
  365.     The Online Electronic Banking(tm) door has two parts.  The door itself,
  366.   which the user uses to enter their check data, and the control program
  367.   which transmits the check data to the OEB BBS.
  368.  
  369.       OEBSYSOP.EXE is used to send your transaction data to ATS for
  370.     processing.  It can be run either by hand or from an event on your BBS.
  371.  
  372.     To run the programs from an event, you would use a batch file like the
  373.   following:
  374.  
  375.     @ECHO OFF
  376.     C:
  377.     CD\BBS\DOORS\OEB
  378.     OEBSYSOP /P1
  379.  
  380.   The /P1 switch specifies to use the first "Modem" defined in OEB.CFG.
  381.   Using /P2 would specify the second "Modem" defined in OEB.CFG.
  382.  
  383.   OEBSYSOP searches the DATA sub-directory for DBF files to send.  It will
  384.   then archive the DBF file and move it to the BACKUP directory.  The
  385.   resulting ZIP file should NOT be deleted.  If the OEBSYSOP program is
  386.   unsuccessful, it will not delete the ZIP file and try to upload it again
  387.   later.  The DATA directory should generally be left untampered.  The
  388.   BACKUP directory contains old DBF files that were successfully sent.  The
  389.   OEBSYSOP program will automatically delete any transaction data older than
  390.   seven days from the BACKUP directory.  If you wish to store your
  391.   transactions for longer than seven days, you will need to archive them
  392.   yourself.
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421. ■ OEB.DOC, Page 7
  422.  
  423.   Files Created
  424.   ═════════════
  425.  
  426.   Configuration Data, used by the doors:
  427.  
  428.     OEB.CFG        Configuration file, may actually be named anything,
  429.                    OEB.CFG is just the default name.
  430.  
  431.     OEB.KEY        Key file recieved after registration for Paper Trail
  432.                    accounts.
  433.  
  434.     OEBPL.KEY      Key file recieved after registration for Paperless
  435.                    accounts.
  436.  
  437.   Catalog Data Files, in the main OEB and CATALOG sub-directory:
  438.  
  439.     CATALOG.OES    Online Electronic Sales Catalog, generated by OEBSETUP.
  440.                    (CATALOG.BAK will exist after making modifications to
  441.                    your catalog, it is wise to back up your catalog
  442.                    periodically)
  443.  
  444.     ANYFILE.GIF    Each item can be assigned a filename, which when used
  445.     ANYFILE.PCX    with extensions that the OES program is configured to
  446.     ANYFILE.DOC    recognize, will allow the user to download files which
  447.     ANYFILE.TXT    can contain photographs or extended descriptions of
  448.                    items for sale.
  449.  
  450.                    The default extensions are GIF, PCX, DOC, and TXT,
  451.                    the program allows up to six extension types.
  452.  
  453.   Transaction Data, in the DATA and BACKUP sub-directories:
  454.  
  455.     ###MERID.DBF   These databases contain transaction data, un-processed
  456.                    data resides in the DATA sub-directory.  After files
  457.                    are transferred by OEBSYSOP, they are moved to the
  458.                    BACKUP directory, where they will stay for seven days
  459.                    before being purged.
  460.  
  461.   Log Files, in the LOGFILES sub-directory:
  462.  
  463.     OEBLOG.###     Contains activity log from OEB and OES.
  464.  
  465.     SALESLOG.###   Contains successful orders placed through OES and
  466.                    the check information of each order.
  467.  
  468.     OEBSYSOP.LOG   Contains OEBSYSOP activity log.
  469.  
  470.   Temporary Files, automatically deleted when program exits:
  471.  
  472.     OESCFG.###     Temporary configuration for OEB when called from OES.
  473.  
  474.     OES###.BBS     Temporary display file for OEB when called from OES.
  475.  
  476.     OEB!###.BAT    Temporary batch file to call OEB, used by OES.
  477.  
  478.     RECIEPT.###    Receipt for for user to download, generated by OES.
  479.  
  480.  
  481. ■ OEB.DOC, Page 8
  482.  
  483.   Afterword
  484.   ═════════
  485.     After you have setup the door and have previewed it, you'll probably
  486.   want to start taking checks online immediately.  Before you can start, you
  487.   need to contact Automated Transaction Services, Inc. and sign up for their
  488.   services.  All information necessary is in SYSOEB.DOC.  When signing up for
  489.   their services, you will also register this program.
  490.  
  491.     To obtain your key file if you did not request it on disk, you must call
  492.   The Source BBS and log on with this account:
  493.  
  494.         Name: OEB SYSOP
  495.     Password: OEB
  496.  
  497.     The Source BBS, (310) 371-5989
  498.  
  499.     That account will get you to a menu at which you can download your key
  500.   file after you have verified your identity as a registered user.  (You
  501.   will be asked for information when you sign up with Automated Transaction
  502.   Services, Inc. that will be used to verify your identity.)
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541. ■ OEB.DOC, Page 9
  542.